home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Reference Guide / C-C++ Interactive Reference Guide.iso / c_ref / csource5 / 358_01 / cbase.rme < prev    next >
Text File  |  1991-09-23  |  7KB  |  209 lines
  1. ----------------------------------------------------------------------
  2. | Citadel                                                            |
  3. | 241 East Eleventh Street * Brookville, IN 47012 * 317-647-4720     |
  4. |                                               BBS 317-647-2403     |
  5. ----------------------------------------------------------------------
  6.  
  7. cbase is distributed in a single compressed file cbaseRL.zip; R and L
  8. would be the release and level numbers, respectively.  The ZIP data
  9. compression utilities are needed to extract the individual files.
  10.  
  11. The following files are obtained by decompressing cbaseRL.zip:
  12.  
  13.    cbase.rme  preliminary information
  14. rlsnotes.txt  release notes
  15.    order.txt  order form
  16.  distrib.txt  application to distribute cbase for profit
  17.    guide.txt  cbase Programmer's Guide
  18.   manxRL.zip  manual entry extraction utility
  19.  blkioRL.zip  blkio library source code
  20.   lseqRL.zip  doubly linked sequential file mngmnt library source code
  21.  btreeRL.zip  B+-tree file management library source code
  22.    cbase.zip  cbase library source code
  23.  cbddlRL.zip  cbddlp source code
  24.   cbddlp.exe  cbddlp executable for DOS
  25. rolodeck.zip  rolodeck example program
  26.   bcbats.zip  installation batch files for Borland C++
  27.  mscbats.zip  installation batch files for Microsoft C
  28.  
  29. cbase is not public domain.  It may be evaluated free for a period of
  30. 30 days.  See the file order.txt for registration and ordering
  31. information.
  32.  
  33. cbase includes four individual libraries, each of which has been
  34. separated into its own compressed file.  The first step in the
  35. installation is to create a directory for each compressed file, then
  36. extract the individual files from that compressed file.  For example,
  37. the following sequence of DOS commands would extract the files from
  38. the main archive, create a directory for the blkio library, and
  39. extract the blkio files into that directory.
  40.  
  41.      > pkunzip cbaseRL.zip
  42.      > mkdir blkio
  43.      > chdir blkio
  44.      > pkunzip ..\blkioRL.zip
  45.  
  46. The remaining installation instructions may be found in Appendix A of
  47. the "cbase Programmer's Guide" (guide.txt).  Also examine any readme
  48. files (files with the extension .rme) for additional installation
  49. notes.  After installing each library, the reference manual for that
  50. library will be in the file libname.man, where libname would be the
  51. name of the library.
  52.                                                      Citadel  91/09/23
  53. The original file cbaseRL.zip should be saved if you wish to pass on
  54. copies of cbase to others.  cbase may not be distributed as individual
  55. files, or in an incomplete or altered form.  The individual files may
  56. not be distributed separately, except for ansi.h, blkioRL.zip, and
  57. manxRL.zip; see their respective readme files for details.  An
  58. application must be filed and approved in order to distribute copies
  59. of cbase for profit.  See the file distrib.txt for an application
  60. form.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.                                                      Citadel  91/09/23
  105. ----------------------------------------------------------------------
  106. | cbase - The C Database Library                                     |
  107. | Version 1.0.2                                                      |
  108. ----------------------------------------------------------------------
  109.  
  110. cbase is a complete multiuser C database file management library,
  111. providing indexed and sequential access on multiple keys.  It features
  112. a layered architecture and comprises four individual libraries.
  113.  
  114.                  -----------------------------------
  115.                  |              ISAM*              |
  116.                  -----------------------------------
  117.                  |         File Structure          |
  118.                  -----------------------------------
  119.                  |          Buffered I/O           |
  120.                  -----------------------------------
  121.                  |           file system           |
  122.                  -----------------------------------
  123.                          cbase Architecture
  124.  
  125.                  -----------------------------------
  126.                  |              cbase              |
  127.                  -----------------------------------
  128.                  |     lseq       |      btree     |
  129.                  -----------------------------------
  130.                  |              blkio              |
  131.                  -----------------------------------
  132.                  |        operating system         |
  133.                  -----------------------------------
  134.                            cbase Libraries
  135.  
  136. The four libraries are:
  137.  
  138.      cbase - C database library for indexed and sequential access
  139.      lseq  - doubly linked sequential file management library
  140.      btree - B+-tree file management library
  141.      blkio - block buffered input/output library
  142.  
  143. cbase internally uses lseq for record storage and btree for inverted
  144. file index storage, which in turn use blkio for file access and
  145. buffering.  blkio is analagous to stdio but based on a file model more
  146. appropriate for structured files such as used in database software.
  147.  
  148. The lower level libraries can also be accessed directly for use
  149. independent of cbase.  For example, the btree library can be used to
  150. manipulate B+-trees for purposes other than inverted files, and the
  151. blkio library to develop new structured file management libraries.
  152.  
  153.  
  154. * ISAM stands for Indexed Sequential Access Method.
  155.  
  156.                                                      Citadel  91/09/23
  157.                             cbase Features
  158.                             --------------
  159. Portable:
  160.   - Written in strict adherence to ANSI C standard.
  161.   - K&R C compatibility maintained.
  162.   - All operating system dependent code is isolated to a small portion
  163.     of the blkio library to make porting to new systems easy.
  164.   - UNIX and DOS currently supported.
  165. Buffered:
  166.   - Both records and indexes are buffered using LRU (least recently
  167.     used) buffering.
  168. Fast and efficient random access:
  169.   - B+-trees are used for inverted file key storage.
  170.   - Multiple keys are supported.
  171.   - Both unique and duplicate keys are supported.
  172. Fast and efficient sequential access:
  173.   - B+-trees also allow keyed sequential access.
  174.   - Records are stored in doubly linked lists for non-keyed sequential
  175.     access.
  176.   - Both types of sequential access are bidirectional.
  177. Multiuser:
  178.   - Read-only locking.
  179. Other Features:
  180.   - Text file data import and export.
  181.   - Custom data types can be defined.
  182.   - Marker used to detect corrupt files.
  183.   - Reference documentation is in standard UNIX manual entry format,
  184.     including errno values.
  185. Utilities:
  186.   - cbddlp, a data definition language processor, is provided to
  187.     automatically generate the C code defining a database.
  188.  
  189.  
  190. $77 plus shipping                                      VISA/MasterCard
  191.  
  192. All source code included.
  193. No run-time fees or royalties.
  194.  
  195. Citadel Software, Inc.
  196. 241 East Eleventh Street
  197. Brookville, IN 47012
  198. 317-647-4720
  199. BBS 317-647-2403
  200.  
  201. An evaluation copy of cbase can be obtained at no charge on the
  202. Citadel BBS, or send $5 for diskette.
  203.  
  204.  
  205.  
  206.  
  207.  
  208.                                                      Citadel  91/09/23
  209.